feat: Public Actor Permissions #2053

raethlo · 2025-10-30T16:34:44Z

This PR adds docs for a new platfrom feature: Actor permissions.

tobice

Gave it a quick look; it still needs a bit of love. I'd even rethink the structure a bit ;D

sources/platform/actors/development/actor_definition/input_schema/specification.md

tobice · 2025-10-31T13:17:46Z

sources/platform/actors/development/actor_definition/input_schema/specification.md

+- `["READ"]` — the Actor may read from the referenced resource(s).
+- `["READ", "WRITE"]` — the Actor may read and write to the referenced resource(s).
+
+Notes:


Let's mention that this will be communicated to the users via the form (the tooltip).

tobice · 2025-10-31T13:20:14Z

sources/platform/actors/development/permissions/images/end_user_ux_limited_permissions.png

This is the copy that needs to be updated. Let's not forget about updating this screenshot as well.

sources/platform/actors/development/permissions/index.md

…y-docs into feat/public-actor-permissions

apify-service-account · 2025-11-05T16:36:07Z

Preview for this PR was built for commit 5b8c483a and is ready at https://pr-2053.preview.docs.apify.com!

apify-service-account · 2025-11-05T17:29:40Z

Preview for this PR was built for commit f0e0ded7 and is ready at https://pr-2053.preview.docs.apify.com!

nmanerikar

A few comments, suggestions and corrections.

sources/platform/actors/development/permissions/index.md

sources/platform/actors/development/permissions/migration_guide.md

sources/platform/actors/running/permissions.md

apify-service-account · 2025-11-10T09:28:17Z

Preview for this PR was built for commit 7413720b and is ready at https://pr-2053.preview.docs.apify.com!

nmanerikar

One final comment, and reminder to update the screenshots.
Other than that, this looks fine.
I assume there will be a review from the content team as well?

nmanerikar · 2025-11-10T09:47:19Z

sources/platform/actors/running/permissions.md

+
+![Full-permissions badge shown on Actor detail page](../development/permissions/images/end_user_ux_full_permissions.png)
+
+Over time, the distinction between these permission levels will become more prominent. For example, Actors requiring full permissions may display an orange badge, appear lower in Store rankings, or show extra confirmation dialogs when you run them. Whenever possible, choose Actors that use **limited permissions**. They are safer, easier to trust, and sufficient for most workflows.


I missed this previously, but in keeping with @TC-MO's comment about dropping mentions of future changes, we should drop this part.

apify-service-account · 2025-11-12T09:23:02Z

Preview for this PR was built for commit 75c6ff81 and is ready at https://pr-2053.preview.docs.apify.com!

apify-service-account · 2025-11-12T09:26:22Z

Preview for this PR was built for commit dda406ef and is ready at https://pr-2053.preview.docs.apify.com!

apify-api/openapi/paths/actors/acts@{actorId}@runs.yaml

sources/platform/actors/development/actor_definition/input_schema/specification.md

apify-api/openapi/paths/actors/acts@{actorId}@runs.yaml

sources/platform/actors/running/permissions.md

TC-MO

Most of the changes are for conciness or logic flow, few comments with questions

First batch of wording, flow and consistency edits Co-authored-by: Michał Olender <92638966+TC-MO@users.noreply.github.com>

…y-docs into feat/public-actor-permissions

apify-service-account · 2025-11-12T13:17:54Z

Preview for this PR was built for commit da41a8aa and is ready at https://pr-2053.preview.docs.apify.com!

apify-service-account · 2025-11-12T13:47:47Z

Preview for this PR was built for commit de855a46 and is ready at https://pr-2053.preview.docs.apify.com!

Another batch of copy/flow Co-authored-by: Michał Olender <92638966+TC-MO@users.noreply.github.com>

apify-service-account · 2025-11-12T13:53:32Z

Preview for this PR was built for commit 3c3c4771 and is ready at https://pr-2053.preview.docs.apify.com!

stale

…fy-docs into feat/public-actor-permissions

apify-service-account · 2025-11-12T14:06:14Z

Preview for this PR was built for commit 2649905f and is ready at https://pr-2053.preview.docs.apify.com!

apify-service-account · 2025-11-13T08:12:42Z

Preview for this PR was built for commit eae6f7fd and is ready at https://pr-2053.preview.docs.apify.com!

TC-MO

Final nits, once this all these comments are addressed we are ready for merge

sources/platform/actors/development/permissions/index.md

sources/platform/actors/development/permissions/migration_guide.md

sources/platform/actors/development/programming_interface/metamorph.md

Co-authored-by: Michał Olender <92638966+TC-MO@users.noreply.github.com>

apify-service-account · 2025-11-13T09:47:29Z

Preview for this PR was built for commit 58b0cacb and is ready at https://pr-2053.preview.docs.apify.com!

apify-service-account · 2025-11-13T09:50:54Z

Preview for this PR was built for commit b59f7ee4 and is ready at https://pr-2053.preview.docs.apify.com!

raethlo added 3 commits October 30, 2025 17:25

Initial actor permission scaffold

e735867

Leave todo's in

8035620

Add a note on metamorphing

bac8219

tobice previously requested changes Oct 31, 2025

View reviewed changes

raethlo added 13 commits November 5, 2025 11:19

Add running/permissions and improve related sections

baaed7d

Merge branch 'master' into feat/public-actor-permissions

8881e0e

Improve wording in running/permissions#how

1f052a3

Merge branch 'feat/public-actor-permissions' of github.com:apify/apif…

740e220

…y-docs into feat/public-actor-permissions

Fix link and wording

4bd040b

Merge branch 'master' into feat/public-actor-permissions

66d6606

Fix vale errors

9e3884e

Fix lint

4c27a81

Fix lint

8a6bd79

Fix link

ea0e652

Whitespace

c7d849e

Fix links in migration.md

f8027bf

Document the forcePermissionLevel qs param

5b8c483

raethlo marked this pull request as ready for review November 5, 2025 17:26

Merge branch 'master' into feat/public-actor-permissions

f0e0ded

raethlo requested review from TC-MO, fnesveda and janbuchar as code owners November 5, 2025 17:26

raethlo requested review from tobice and removed request for fnesveda and janbuchar November 5, 2025 17:27

raethlo requested a review from nmanerikar November 6, 2025 09:25

nmanerikar requested changes Nov 6, 2025

View reviewed changes

Wording changes from code review

1e10169

nmanerikar approved these changes Nov 10, 2025

View reviewed changes

raethlo added 2 commits November 12, 2025 10:19

Remove a future reference

75c6ff8

Merge branch 'master' into feat/public-actor-permissions

dda406e

Update screenshots

b0de127

TC-MO requested changes Nov 12, 2025

View reviewed changes

raethlo and others added 4 commits November 12, 2025 12:48

Apply suggestions from code review

35e7af8

First batch of wording, flow and consistency edits Co-authored-by: Michał Olender <92638966+TC-MO@users.noreply.github.com>

Merge branch 'feat/public-actor-permissions' of github.com:apify/apif…

20341b2

…y-docs into feat/public-actor-permissions

Apply suggestions from code review

52503cd

Fix hard tabs

da41a8a

Merge branch 'master' into feat/public-actor-permissions

de855a4

Apply suggestions from code review

3c3c477

Another batch of copy/flow Co-authored-by: Michał Olender <92638966+TC-MO@users.noreply.github.com>

raethlo requested a review from TC-MO November 12, 2025 14:00

raethlo added 2 commits November 12, 2025 15:02

Make bolding consistent

6e6185f

MMerge branch 'feat/public-actor-permissions' of github.com:apify/api…

2649905

…fy-docs into feat/public-actor-permissions

Correct current default mentions

eae6f7f

TC-MO approved these changes Nov 13, 2025

View reviewed changes

raethlo and others added 2 commits November 13, 2025 10:44

Apply suggestions from code review

58b0cac

Co-authored-by: Michał Olender <92638966+TC-MO@users.noreply.github.com>

Merge branch 'master' into feat/public-actor-permissions

b59f7ee


		![Full-permissions badge shown on Actor detail page](../development/permissions/images/end_user_ux_full_permissions.png)

		Over time, the distinction between these permission levels will become more prominent. For example, Actors requiring full permissions may display an orange badge, appear lower in Store rankings, or show extra confirmation dialogs when you run them. Whenever possible, choose Actors that use limited permissions. They are safer, easier to trust, and sufficient for most workflows.

feat: Public Actor Permissions #2053

Are you sure you want to change the base?

feat: Public Actor Permissions #2053

Conversation

raethlo commented Oct 30, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

tobice left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

tobice Oct 31, 2025

Choose a reason for hiding this comment

Uh oh!

tobice Oct 31, 2025

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

apify-service-account commented Nov 5, 2025

Uh oh!

apify-service-account commented Nov 5, 2025

Uh oh!

nmanerikar left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

apify-service-account commented Nov 10, 2025

Uh oh!

nmanerikar left a comment

Choose a reason for hiding this comment

Uh oh!

nmanerikar Nov 10, 2025

Choose a reason for hiding this comment

Uh oh!

apify-service-account commented Nov 12, 2025

Uh oh!

apify-service-account commented Nov 12, 2025

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

TC-MO left a comment

Choose a reason for hiding this comment

Uh oh!

apify-service-account commented Nov 12, 2025

Uh oh!

apify-service-account commented Nov 12, 2025

Uh oh!

apify-service-account commented Nov 12, 2025

Uh oh!

apify-service-account commented Nov 12, 2025

Uh oh!

apify-service-account commented Nov 13, 2025

Uh oh!

TC-MO left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

apify-service-account commented Nov 13, 2025

Uh oh!

raethlo commented Oct 30, 2025 •

edited

Loading